package com.woniuxy.service;

import com.woniuxy.entity.DTO.algorithm.ProductSalesPredictionDTO;
import com.woniuxy.util.PageResult;
import java.util.List;

/**
 * @Author 陈华庆
 * @Date 2025/7/23 2:23
 * @Description TODO
 * 商品销售预测服务接口
 * 提供商品周销量预测和库存预警功能
 */
public interface IProductSalesPredictionService {
    /**
     * 预测指定商品未来4周的销量
     * @param shopId 商品ID
     * @return 包含每周预测数据的列表
     */
    List<ProductSalesPredictionDTO> predictSalesByShopId(Integer shopId);

    /**
     * 批量预测所有商品未来4周的销量并生成库存预警
     * @param pageNum 当前页码
     * @param pageSize 每页数量
     * @return 分页的预测结果列表
     */
    PageResult<ProductSalesPredictionDTO> batchPredictSalesAndStockWarning(Integer pageNum, Integer pageSize);
}
